home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1995 April / Internet Tools.iso / infoserv / gopher / Mac_server / AppleSearch_Info.Z / AppleSearch_Info
Encoding:
Text File  |  1995-01-12  |  6.8 KB  |  161 lines
  1. January 12, 1995
  2.  
  3. Gopher Surfer 1.1b1 will only work with AppleSearch version 1.5 or
  4. later.
  5.  
  6. Here is a short blurb about GopherSurfer & AppleSearch.  Followed
  7. by some setup instructions so those who have AppleSearch can try it
  8. with their Gopher Surfer software.
  9.  
  10. AppleSearch is a commercial product of Apple Computer Co, Inc.
  11.  
  12.  
  13. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  14. Macintosh Gopher+ server with full-text search capability
  15.  
  16. The University of Minnesota Gopher Development team is pleased to announce 
  17. a new version of the Macintosh Gopher Surfer application (version 1.1b1). 
  18.  
  19. Gopher Surfer is a Gopher+ server that runs under the Macintosh operating 
  20. system and makes it possible for people who do not want to run a Unix 
  21. Gopher server to publish information in gopherspace. 
  22.  
  23. This is an updated version of Gopher Surfer that works with Apple
  24. Computer's AppleSearch software to provide full-text search capabilities
  25. for Mac-based Gopher servers. This means that there is an alternative to 
  26. running WAIS search engines on Unix systems for those that want to avoid 
  27. Unix or take advantage of the setup and administration utilities that Apple
  28. includes as part of AppleSearch. If you are already running an AppleSearch 
  29. server, you might also use gopher client software and Gopher Surfer to make 
  30. the information on the AppleSearch server accessible to non-Macintosh
  31. systems (or available via a TCP/IP network).
  32.  
  33.  
  34. How it works
  35. ------------
  36. Gopher Surfer acts as both a Gopher document server and a gateway to translate 
  37. between AppleSearch's client-server protocol and the Internet Gopher protocol . 
  38. To do this, Gopher Surfer acts as an AppleSearch client. When you tell Gopher 
  39. Surfer to run with AppleSearch, you make a PPC connection to either a local or 
  40. remote AppleSearch server, and the AppleSearch server appears as a Gopher 
  41. search engine to gopher clients. Because Gopher Surfer is using PPC to connect 
  42. to the AppleSearch server you can either run the AppleSearch software on the 
  43. same Macintosh as Gopher Surfer, or have Gopher Surfer connect to the 
  44. AppleSearch software via an AppleTalk network. Note that AppleSearch is 
  45. software that you purchase from Apple, and AppleSearch servers require a 
  46. 68040-based Macintosh.
  47.  
  48.  
  49. Other Features
  50. --------------
  51. Gopher Surfer supports Gopher+ features such as electronic forms and alternate 
  52. representations for data documents. Gopher Surfer also has an integral Gopher 
  53. link editor and preview mode that you can easily reference items on other 
  54. gopher servers.
  55.  
  56.  
  57. Caveats
  58. -------
  59. This is a beta-test version of Gopher Surfer. Please e-mail bug reports, 
  60. comments, or even compliments to <gopher@boombox.micro.umn.edu>
  61.  
  62. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  63.  
  64.  
  65. Instructions
  66. =============
  67.  
  68. 1.  You should have installed the AppleSearch server on a 68040 macintosh.
  69.     Those are the AppleSearch limitations, not mine.  :-)
  70.  
  71. 2.  Install the AppleSearch Client software on the machine which will have
  72.     the GopherSurfer application running on it.
  73.  
  74.     NOTE:  The AppleSearch server and the GopherSurfer applications do not
  75.     need to be running on the same macintosh.
  76.  
  77. 3.  If the AppleSearch server and the GopherSurfer application are running
  78.     on the same computer skip to #4.
  79.  
  80.     If you have AppleSearch server running on a different computer there
  81.     are some things that must be set up correctly.  They are:
  82.  
  83.     a.  The AppleSearch server machine must have File Sharing & Program
  84.         Linking turned on.  Do this in the Sharing Setup Control Panel.
  85.  
  86.     b.  I strongly recommend you set up a specific account for the
  87.         GopherSurfer application.  Then it is easy to check if the
  88.         GopherSurfer is currently connected.  Do this in the
  89.         Users & Group Control Panel.
  90.  
  91.     c.  The Information server up by AppleSearch server will be present
  92.         in folders on the AppleSearch server machine.  For instance, on my
  93.         computer I have two folders named 'AppleSearch Indexes' &
  94.         'AppleSearch Information Sources'.
  95.  
  96.         These names are determined when you set up the raw data files and
  97.         index them.
  98.  
  99.         NOTE:  You must allow the username you set up permission to see
  100.         the Data folder (and its contents) & the Index folder (and its
  101.         contents).
  102.  
  103. 4.  After you start up the GopherSurfer application locate the
  104.     'Other Preferences' menu in the Configuration window.  Choose
  105.     'AppleSearch Configuration' from this menu.  Now click on the
  106.     'Select' button to choose an AppleSearch server to utilize.  This
  107.     will bring up the Program Linking dialog.  It looks remarkably like
  108.     the Chooser.
  109.  
  110.     There are 3 boxes in the window.  Top left shows any Macintoshes
  111.     allowing Program-to-Program Communication in the currently selected
  112.     zone.  Bottom left shows the zones on your AppleTalk network.
  113.     Top right shows the programs available on the currently selected machine.
  114.  
  115.     Select the AppleTalk zone containing the machine running an AppleSearch
  116.     server.  Then select the name of the Macintosh you wish to connect to.
  117.     Then select AppleSearch server.  Now click on the OK button.
  118.  
  119.     This selects which AppleSearch server to use.  Now we must enter the username
  120.     and password for connecting to this AppleSearch server.  So click on the
  121.     'Auto Connect on startup' checkbox.  This will prompt you to enter a username
  122.     and password.
  123.     
  124.     If the AppleSearch server you are connecting to is the same machine running
  125.     GopherSurfer leave both fields blank.  Otherwise enter the username
  126.     & password you created/setup in step 3.
  127.     
  128.     NOTE:  Re-read 3c if the AppleSearch server and the GopherSurfer
  129.     applications are not running on the same machine.  It is possible
  130.     to successfully log in but still not have access to the data because
  131.     you have not set the permissions correctly on the folders where the
  132.     data & Index files reside.
  133.  
  134.  
  135. 5.  If you successfully log in the 'Auto Connect on startup' option will
  136.     show an 'X' in the checkbox.  Otherwise check your username/password
  137.     combination to be sure it is correct.
  138.  
  139. 6.  To make an AppleSearch query (search) engine visible to clients
  140.     connecting to your server do the following.
  141.     
  142.     a.  Choose 'Preview Gopher Tree' from the Gopher menu.  Navigate to
  143.     the location/directory to contain the search engine.  Now choose
  144.     'Place AppleSearch Database' from the 'Gopher' menu.
  145.     
  146.     This prompts you to select the database you are placing.  Also to enter
  147.     a user visible title for clients to see.
  148.     
  149.  
  150. If you use AppleSearch and GopherSurfer I would be interested in
  151. hearing your comments.
  152.  
  153. Caveats
  154. -------
  155. This is a beta-test version of Gopher Surfer. Please e-mail bug reports, 
  156. comments, questions, or even compliments to <gopher@boombox.micro.umn.edu>
  157.  
  158. Enjoy,
  159. Dave Johnson
  160. Gopher Development Team
  161. University of Minnesota